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This memo contains thoughts on the stack window for the new debugger interface. This is based 
on my ideas and suggestions from the meetings, and is NOT a final design. This is only meant to 
stimulate discussion for the next meeting (I know we will come up with at least 6 other proposals). 

* The debugger is created with (among other things) a window for manipulating the stack. 

* Upon entering the debugger for the first time, this window is initialized with the context of 
whatever process is currently running. If you look at this window (i.e., make it "current", move 
the cursor into the window), it would contain all of the information associated with this context 
(configuration, module, global frame, local frame, procedure). 

Each stack window: 

* Has a (Tools style) menu containing the standard set of window operations. 

* Is identified by its process which is displayed in the header of the window. 

* Has a context that is current (selected, marked, call it what you like); this is the context in which 
expressions are interpreted. 

* When you invoke the stack command, giving it a process as a parameter (current selection 
perhaps), a Stack window is created containing the infonnation associated with this process 
(should it also become the current context for the debugger's symbol lookup?). 

* When you are "in" this window, commands are invoked by single letters. The functions 
provided include: next procedure on the call stack, display the local variables, make this the 
current context, show die source line, load the source file into a window, jump n levels. 

* We can also have single letter type-in commands in this window for directing program 
control, i.e., P for Proceed, Q for Quit, and K for Kill session. 

* A subwindow of the stack window is reserved for showing context infonnation about the 
current configuration, psb, module, global frame, and local frame. The rest of this 
subwindow is used to show the procedure call stack. 

Input functions; 

* stack commands such as next procedure on the stack, display the variables, make tliis the 
context, display the source line, jump n (or -n) levels on the stack 



input to the interpreter 
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Suggestions for stack window 



Output functions: 

* display of local variables 

* display the source line 

* output from the interpreter 

* messages like "No symbols for nnnnnnnB" 
Problems: 

* There needs to be a notion of THE current context, in much the same way as there is now. 
How to display this: a current context stack window, as distinguished from stack "viewers" 
that allow you examine the stack of a particular process without changing the overall 
context? Having n stack windows complicates the proposed scheme for changing contexts 
to something other than what is visible (i.e.. to a different configuration). In addition, when you 
do change to a new configuration, the process context is set to nil so there is no identifier 
for the stack window. 

* How much feedback to user type-in? What gets entered into a log? 

* We need to be able to change THE current context both within an exisiting stack window 
as well as switching between stack windows. Having multiple stack windows makes it easy 
to rapidly switch contexts between different processes. AH we need is an indication of 
which stack window is THE current one (how about a graphic indication like an asterisk or using 
THE current selection, whatever that is). 

I have included some sample interfaces that we can use as a basis for discussion (please disregard the 
IntemalDebug.ts window, the position of the cursor, and some of the file names; these are all for use in creating the 
press files): 

* Figures 1 and 2 demonstrate the proposal for having a small input feedback window at the 
bottom of the stack window. Figure 1 shows it echoing the Variable command and 
displaying the variables in the window to the right (it should be called Debug.Answers). Figure 2 
shows interpreter input (invoked by SP) in the feedback window and output in the 
Debug.Answers window. Both of these commands were evaluated in terms of the current 
context (highlighted) in the stack window. 

* Figures 3 and 4 demonstrate the proposal for having a Debug.Interpreter window. Figure 3 
has the window to the right of the stack window (or part of it) and Figure 4 has it on the 
bottom (the irshape we discussed). Both of these commands were evaluated in terms of the 
current context (highlighted) in the stack window. 
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BEGIN 

bbtable: ARRAY [S. . SIZE[BitBltDefs . BBTable] ] OF WOROj 

bbptr: BitBltDefs.BBptr = EVEN[BASE[bbtable]]; 

mapaddr: BMptr ^ rectangle . bitmap. addrj 

wordsperline: CARDINAL = rectangle .bitmap .wordsperlinei 

dlx: xCoord ^ rectangle. x0+x0j 

dty; yCoord ^ rectangle. yQ+ySj 

dw: xCoord ^ MIN[rectangle .cw, width]^ 

dh: yCoord ^ MIN[rectangle . ch, height]i 

bbptrt «• [0, FALSE, FALSE, gray, replace, 0, mapaddr, wordsperline, 



PSBv2337B 



Configuration : XDebug 
Module: Rectangles A 
e: 172570B, L: 164320B 



ClearBoxanRectangle 



Set Jumps tripe 

DoWork 

WindowExecutive 
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ii^DebugiAnswersi 
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**+ interrupt **^= 
>tUserProc [confirm] 
Proc : Press 
Press file name: dui2, 
dui2 . press . , .0 



press 
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— RectanglesA.Mesa Edited by Sandman on May 12, 1978 2:48 PM 

DIRECTORY 

BitBltDefs: FROM "bitbltdefs" USING [BBptr, BBTable, BITBLT], 
InlineOefs: FROM "inlinedefs" USING [BITAND], 
lODefs: FROM "iodefs" USING [OR, DEL, SP], 
RectangleOefs: FROM "rectangledef s" USING [ 

BMHandle, BMptr, FAptr, FCDptr, FontHeader, GrayArray, GrayPtr, min 
height, 

rninwidth, RectangleErrorCode, Rptr, xCoord, yCoord]j 



PSb'i2337b -•['''-■ '--/■^-■mm^ --mm^^--^^ 


Configuration : XDebug 
Module : RectanglesA 


ClearBoxInRectangle, L: 1643296 (in Rectangl 
esA, G:172570B) 
>rectang1e=160737Bt 

X0=1 

width=9 

y0=13 

height=434 

cirav=164124Bt 

bbtable=(17)[ 1, 14B, ... , 8] 

bbptr=164252Bf 

mapaddr=122000Bt 

wordsperline=40B 

d1x=l 

dty=13 

dw=9 

dh=434 


G: 172570B, L: 164320B 




■C lear^bQselnKecttancile^^^^ 


SetJunipStripe 

DoWork 

WindowExecutive 


Variables 
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Please try again. 
>tUserProc [confirm] 
Proc: Press 

Press file name: duil. press 
duil. press . . .D 
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BEGIN 

bbtable: ARRAV [8. . SI2E[BitBltDefs .BBTable] ] OF WOROj 

tabptr: BitBltDefs.BBptr = EVEN[BASE[bbtable]]i 

mapaddr; BMptr ^ rectangle .bitmap. addr^ 

wordsperline: CARDINAL = rectangle .bitmap .wordsperlinei 

dlx: xCoord * rectangle .x0+x0j 

dty: yCoord *• rectangle. y0+y0j 

dwi xCoord ^ MIN[rectangle .cw, 

dh: yCoord ^ MIN[rectanqle .ch, 

bbptrt- 4. [0, FALSE, FALSE, qray, 



width] j 
height]; 
replace.. 



0, mapaddr, wordsperline, 



pm^if,:23d7bm!M/-' ■-.-■'■m-^-mr- r-- 


■--^^^^mmQ e b u g ■:irl:n t e r p r e t e r '--vf : 


'mfiM:'-^--'-. :'---^^^:-^#'-V'^-i^^:''':--^.^ 


Configuration : XDebug 
Module: RectanglesA 
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= 17B 


G: 172570B, L: 164320B 
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SetJumpStripe 

DoWork 

WindowExecutive 
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++:+: interrupt *** 
>tLlserProc [confirm] 



Proc: Press 
Press file name: 
duiS. press . . . D 



dui3. press 
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BEGIN 

bbtable: ARRAY [0. .SIZE[BitBltDefs .BBTable] ] OF WORD; 
bbptr: BitBUDefs.BBptr = EVEN[BA3E[btatable]] j 
mapaddr: BMptr <r rectangle .bitmap. addrj 
wordsperline: CARDINAL = rectangle .bitmap .wordsperlinej 
dlx: xCoord ^ rectangle. x0+x0j 
dty: yCoord ^ rectangle. y0+y0i 
dw: xCoord ^ MIN[rectangle .cw, width]; 
dh: yCoord ^ MIN[rectangle , ch, height]; 

bbptrt 4- [0, FALSE, FALSE, gray, replace, 0, mapaddr, wordsperline, 
dlx, dty, dw, dh, mapaddr, wordsperline, dlx, dty, gray[0], 



PSBTS2337&' 



Conf 1 gurat 1 on : XDebug 
Module: RectanglesA 
G: 172570B, L: 164320B 



QilearBoxI nRectang 1 e 



yetJumpStripe 

DoWork 

WindowExecutive 
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--No symbols for lirdfelS[.im' 
> — this is so I can proceed 
> Proceed [confirm] 
*** interrupt *** 
>tUserProc [confirm] 
Proc; Press 

Press file name: dui4. press 
dui4. press. . .D 



Debug 1 1 nt erpfee t er 



ptr .fie ld[ index ]t = 17B 



